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Slid1  ION  1  GENERAL  DESCRIPTION 


^  1.1  Purpose  of  the  Users  Manual 

'>  The  objective  of  the  Users  Manual  for  the  UTC-UIC  Directory  File 

•  f  ^ 

Generator  (UTCTAB)  is  to  familiarize  the  JOPS^user  and  technician 
with  the  file  contents  and  to  provide  the  necessary  information  to 
utilize  the  directory  file  generation  program. 

1. 2  Project  References 

a.  The  following  staff  agencies/commands  are  desginated  responsibilities 
as  indicated: 

(1)  Users  -  OJCS,  Unified  Commands,  others  as  required. 

(2)  Program  maintenance  and  exportation  -  NMCSSC,  JOPS  Division,  B355. 
SECTION  2  SYSTEM  SUMMARY 

2.1  System  Application 

a.  UTCTAB  generates  the  indexed  sequential  data  and  index 
files,  referenced  singularly  as  the  UTC-UIC  Directory  File.  This 
permanent  on-line  file  is  necessary  for  execution  of  the  FRG  FORSTAT 
retrieval  modules,  F12K  and  F38. 

b.  F12K  and  F38  both  make  retrievals  from  the  FORSTAT  Active 
Unit  File  (FORSTQ)  based  on  the  Unit  Type  Code  and  the  Unit  Identi¬ 
fication  Code.  The  UTC-UIC  Directory  File  provides  a  separate  index 
to  FORSTQ  records  through  the  Unit  Type  Code  and  associated  Unit 
Identification  Code. 

c.  Once  the  UTC-UIC  Directory  File  has  been  generated,  retrieval 
time  against  the  FORSTQ  file  is  minimized. 

d.  UTCTAB  is  designed  to  provide  the  operation  planner  with  the 
actual  units  currently  available  for  his  scenario. 


2.2  System  Operation 

a.  A  breakdown  of  the  information  flow  through  the  system  is 
illustrated  by  a  System  Information  Flowchart  contained  in  Appendix 

m  n  gjirnroj  w  w  ^  1  ,  w  „  _  _ 


b.  User  interface  with  the  system  consists  of  submission  of  the  job 
deck  to  run  UTCTAB  and  review  of  the  hard-copy  diagnostics  produced  by 
UTCTAB. 

2 . 3  System  Configuration 

2.3.1  Equipment  Environment 

UTCTAB  con  be  executed  on  any  HIS  6000  computer  system  meeting 
WWMCCS  standards.  The  WWMCCS  configuration  includes: 

a.  HIS  6060  Central  Processor 

b.  System  Control  Unit  (128K  memory) 

c.  Input  Output  Controller  IOC/ I 

d.  CPR201  Card  Reader 

e.  PRT201  High  Speed  Printer 

f.  DSS181  Disk  with  DSU181 

g.  MTH405  Nine-Track  Magnetic  Tape  Handler 

2.3.2  Software  Environment 

a.  General  Comprehensive  Operating  System  COCOS) 

b.  Indexed  Sequential  Processor  (ISP) 

c.  HIS  COBOL  Compiler 

d.  HIS  File  System  (or  HIS  File  Management  System) 

2.4  System  Organization 

UTCTAB  is  organized  as  a  two  activity  job.  The  two  separate  activities 
are  as  follows: 


a.  Activity  one  retrieves  records  from  the  FORSTQ  file,  based  on 
Unit  Identification  Code  (UIC)  and  Unit  Type  Code  (UTC) .  When  a  record 
has  been  retrieved,  the  UIC  and  UTC  from  that  record  are  moved  to  the 
directory  record  area.  After  all  directory  records  have  been  built, 
they  are  sorted  in  ascending  order,  using  l/TC  as  a  major  sort  and  UIC 
as  a  minor  sort.  A  count  is  made  of  the  UIC's  having  the  identical 
UTC.  This  ascending  count  is  inserted  in  each  record  and  reset  to 

one  when  the  UTC  changes.  The  sorted  indexed  sequential  file  is  then 
ready  to  be  used  as  a  separate  index  to  FORSTQ  records,  based  on  the 
type  of  unit. 

b.  After  the  directory  file  has  been  built  in  the  first  activity 
of  UTCTAB,  activity  two  writes  the  file  on  a  magnetic  tape  providing 

a  separate  backup  copy.  Should  the  permanent  directory  file  be  lost 
through  computer  malfunction,  it  can  be  restored  from  a  previous  back¬ 
up  tape  without  re-running  UTCTAB. 

2.5  System  Performance 

a.  The  input  data  to  UTCTAB  is  provided  by  the  FORSTQ  Data  Base 
and  the  FORSTAT  Copy  Library.  Both  the  FORSTQ  Data  Base  and  the  FORSTAT 
Copy  Library  reside  on  on-line  permanent  disk  storage  space. 

b.  The  outputs  produced  by  UTCTAB  are  the  indexed  sequential  UTC- 
UIC  Directory  File,  the  backup  of  the  file,  and  the  report  of  the  number 
of  records  generated  during  each  run.  The  directory  file  resides  on 

an  on-line  permanent  disk  pack.  The  back-up  for  the  file  is  maintained 
on  a  9  -  track  magnetic  tape.  The  report  is  output  on  the  high-speed 
(1200  1pm)  system  printer. 
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c.  The  response  time  is  dependent  upon  the  computer  system  workload 
and  the  status  of  the  FORSTQ  file.  UTCTAB  cannot  be  executed  during  FORSTAT 


file  updates,  due  to  a  read  denial  by  GCOS.  Should  UTCTAB  be  submitted 
during  the  FORSTAT  updates,  execution  will  be  delayed  until  update 
completion. 

d.  UTCTAB  is  currently  limited  to  using  the  FORSTQ  Data  Base. 

e.  UTCTAB  checks  to  ensure  that  each  read  from  the  FORSTQ  file 
is  successful  before  building  each  directory  record.  Should  an  un¬ 
successful  read  occur,  a  message  will  be  printed  on  the  output  report 
indicating  an  error  and  processing  will  continue. 

f.  UTCTAB  is  currently  executing  the  generate  and  save  activities 

in  approximately  twelve  minutes.  The  rate  is  expected  to  remain  constant. 

g.  UTCTAB  is  currently  designed  to  build  the  directory  file  based 
on  the  UTC-UIC  combination.  With  minor  modifications  to  the  source  pro¬ 
gram,  a  directory  based  on  a  different  key  field  could  be  built.  However, 
these  changes  would  preclude  UTCTAB  from  supporting  the  FRG  modules. 

UTCTAB  is  also  designed  to  interface  with  the  FORSTQ  Data  Base.  In  order 
to  interface  with  the  full  FORSTAT  file,  several  modifications  to  the 
system  would  be  necessary. 

h.  System  reliability  is  enhanced  by  the  ability  to  execute  from 
either  an  object  library  or  a  source  deck. 

2.6  System  Data  Base, 

a.  UTC-UIC  Directory  File.  The  UTC-UIC  Directory  File  contains 


an  index  to  the  FORSTQ  file  based  on  the  Unit  Type  Code. 


b.  FORSTAT  Active  Unit  File  (FORSTQ) .  The  FORSTQ  file  contains 


status  and  identity  information  on  all  of  the  active  units  maintained 
on  the  full  FORSTAT  data  base.  The  FORSTQ  file  is  utilized  as  a  subset 
of  the  FORSTAT  system. 

2.7  General  Description  of  Inputs,  Processing,  and  Outputs. 

a.  The  required  inputs  for  directory  file  generation  are  the  FORSTQ 
file  and  two  data  files  containing  the  ISP  parameters  for  both  the  UTC- 
UIC  Directory  File  and  the  FORSTQ  file.  Additionally,  when  UTCTAB  is 
compiled,  the  FORSTAT  Copy  Library  is  required.  The  library  provides  the 
latest  FORSTAT  file  description. 

b.  In  the  compilation  phase,  the  UTCTAB  source  program  obtains  the 
FORSTQ  file  description  from  the  copy  library.  The  ISP  parameters  for 
both  FORSTQ  and  the  directory  file  are  retrieved  from  the  external 
parameter  files.  Once  this  information  has  been  accessed,  UTCTAB  reads 
each  record  from  the  FORSTQ  and  constructs  records  for  the  directory 
file.  During  execution  the  output  report  is  produced.  After  file 
creation  is  complete,  a  save  of  the  file  is  made  on  magnetic  tape. 

c.  System  outputs  are  the  UTC-UIC  Directory  File,  a  magnetic  tape 
back-up  and  a  printed  report. 
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SECTION  3  STAFF  FUNCTIONS  RELATED  TO  TECHNICAL  OPERATIONS 


3. 1  Input  Requirements 

a.  UTCTAB  should  be  run  as  a  recurring  production  job  on  a 
weekly  basis  by  the  user  site's  JOPS  Support  Croup.  This  weekly  run 
completely  regenerates  the  directory  file  with  the  current  FORSTQ 
UIC's  and  UTC's.  Intermediate  runs  can  be  made  on  an  "as  needed" 
basis  to  support  exercises  and  special  functions  where  the  latest 
information  is  imperative. 

b.  User  input  is  in  the  form  of  the  run  decks  illustrated  in 
Appendix  A.  All  associated  user  input  is  contained  in  the  run  decks. 

3.2  Composition  Rules 

The  input  length,  format,  and  punctuation  follow  the  standard  H6000 
rules  for  Job  Control  Language  and  Index  Sequential  Processing. 

3.3  Vocabulary 

No  special  vocabulary  is  required  for  system  execution. 

3. 4  Input  Formats 

The  input  format  for  the  FORSTQ  file  taken  from  the  FORSTAT  Copy 
Library  appears  in  Appendix  B,  Figure  1.  The  input  ISP  parameters 
for  the  FORSTQ  file  and  the  UTC-UIC  Directory  File  appear  in  Appendix 
B,  Figures  2  and  3  respectively. 


UTCTAB  is  a  stand-alone  job  which  can  be  executed  in  a  "load  and  go" 
mode  from  an  object  library.  The  user  can,  at  his  option,  maintain 
the  source  file  and  execute  in  a  "compile,  load  and  go"  mode,  thus 
adding  an  additional  activity  to  the  job  stream.  Appendix  A,  Figure  1 
illustrates  the  Job  Control  Language  (JCL)  required  to  create  the 
ojbect  library.  Appendix  A,  Firgure  3  shows  file  generation  from  the 
object  library  and  file  save.  Appendix  A,  Figure  4  shows  file 
generation  from  the  source  file  and  file  save.  Should  it  become  necessary 
to  restore  the  directory  file  from  tape.  Appendix  A,  Figure  5  shows 
the  run  stream  for  this  activity. 

3.6  Output  Requirements 

Prior  to  the  initial  execution  of  UTCTAB,  permanent  file  space  must  be 
created  for  the  directory  file,  as  illustrated  in  Appendix  A,  Figure  2; 
and  a  9  -  track  magnetic  tape  must  be  allocated  for  the  directory  file 
back-up. 

3.7  Output  Formats 

The  output  format  for  the  UTC-UIC  Directory  File  appears  in  Appendix 
B,  Figure  4. 

3.8  Sample  Output 

A  sample  of  the  output  report  from  UTCTAB  appears  in  Appendix  C, 

Figure  1. 


3.9  Utilization  of  System  Output 

As  stated  previously,  'he  UTC-UIf  Directory  File  generated  by  ITTCTAB 
is  required  by  the  FRG  F°r>  »TAi  retrieval  modules. 


APPENDIX  A 


JOB  CONTROL  LANGUAGE  FOR  THE  UTC-UIC  FILE  GENERATOR  CUTCTAB) 

1.  The  purpose  of  this  appendix  is  to  provide  the  user  with  examples 

of  all  of  the  job  control  language  required  by  UTCTAB.  The  three  areas  of 
concern  are: 

a.  Creation  of  file  space  for  all  UTCTAB  unique  files. 

b.  Generation  of  data  and  libraries. 

c.  File  restoration  due  to  computer  malfunction. 

2.  Figure  1  illustrates  file  space  allocation  for  the  object  library 
and  generation  of  the  library.  These  two  activities  are  run  only  once, 
when  the  user  will  be  executing  in  the  "load  and  go"  mode. 

3.  Figure  2  is  an  example  of  the  job  control  language  necessary  to 
create  the  space  for  the  UTC-UIC  Directory  File. 

4.  Figure  3  illustrates  generation  of  the  directory  file  data,  utilizing 
the  "load  and  go"  mode.  The  run  streams  represented  in  Figures  1  and  2 
must  be  executed  before  this  activity. 

5.  Figure  4  depicts  how  to  generate  directory  file  data  in  the  "compile, 
load  and  go"  mode.  This  run  stream  may  be  executed  to  update  the  file  after 
space  has  been  allocated  (reference  figure  1). 

6.  Figure  5  shows  how  to  restore  the  directory  from  the  backup  tape.  This 
activity  is  used  when  the  permanent  directory  file  has  been  destroyed  and  the 
situation  precludes  re-generating  the  file  through  an  update  run. 
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APPENDIX  B 


INPUT  AND  OUTPUT  FORMATS  FOR  UTCTAB 

1.  The  purpose  of  Appendix  B  is  to  display  the  format,  or  file  description, 
of  all  data  either  input  to,  or  output  from,  UTCTAB.  The  file  formats  for 
the  FORSTQ  input  file  and  UTC-UIC  Directory  output  file  and  the  contents  of 
the  two  ISP  parameters  files  are  shown. 

2.  Figure  1  is  the  file  description  of  the  FORSTQ  input  file.  This  figure 

is  comprised  of  twenty-one  pages  displaying  every  record  type  in  the  FORSTQ  file 

3.  Figure  2  depicts  the  ISP  Parameters  for  the  FORSTQ  file.  These  parameters 

are  the  data  for  the  file  referenced  by  the  file  code  DD,  and  must  be  inserted 

in  the  job  stream  exactly  as  displayed.  (See  Appendix  A,  Figures  3  and  4). 

4  Figure  3  contains  the  ISP  parameters  for  the  UTC-UIC  Directory  File. 

They  are  the  data  for  the  file  referenced  by  the  file  code  DW.  As  with  the 
FORSTQ  parameters,  this  data  must  be  inserted  into  the  job  stream  exactly  as 
displayed  (see  Appendix  A,  Figures  3  and  4). 

5.  Figure  4  is  the  file  description  of  the  Directory  File  output  record. 

This  format  is  used  for  both  the  permanent  file  and  the  tape  backup  file. 
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r<o  ff-^TOT-PRO 
’3  FILLIP 


PKTURF  X. 

pICTmRF  x. 

° I CTURF  X(53>. 


IF  FILLFI. 

?r>  Fc-CDTYP-PPc  "ICTUPF  X(3>. 

io  FIL'.FO  PICTURF  X(1?P>. 

rF-R'FCOPO-LrVFL-3-TVPF-3^  PFDEFINFS  FS-D ATA-GROUR 
10  cc-D70-C ARO-OATA-^SOUP. 
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Col.  1 

Col.  8 

Col.  16 

ISP 

RECORD 

RECSZ=34 , KEYSZ= 1 8 , KEYOFF=0 

ISP 

INDEX 

FC=F1 ,PAGESZ*1024 

ISP 

DATA 

FC =FS , PAGESZa 1024, PAGE  FI  La  1 00 

Figure  2.  ISP  parameters  for  FORSTQ  file 


Col.  1 

Col.  8 

Col.  16 

ISP 

RECORD 

RECSZ= 3 , KEYSZ=9 , KEYOFF=0 

ISP 

INDEX 

FC=IX, PAGESZ=1024 

ISP 

DATA 

FC=DT, PAGESZ= 1024, PAGEFI L=  100 

Figure  3.  ISP  parameters  for  Directory  File 
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UIC- DIRECTORY-RECORD. 


05 

F-UNIT-TYPE-CODE 

PIC 

X  (05 ) 

05 

F-UIC -COUNT 

PIC 

9(04) 

05 

F-UIC 

PIC 

X  (06) 

05 

FILLER 

PIC 

X  ( 02 ) 

Figure  4.  Output  format  for  Directory  File 
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OUTPUT  REPORTS  FORM  UTCTAB 

1.  Appendix  C  provides  an  example  of  the  output  report  produced  by 
UTCTAB,  As  UTCTAB  is  designed  to  build  the  Directory  File,  rather 
than  generate  a  report,  these  reports  are  in  the  manner  of  diagnostic 
and  trace  displays. 

2.  Figure  1  is  an  example  of  the  final  processing  display.  It  is  a 
two  line  report  indicating  the  number  of  unique  UTC's  encountered  and 
the  number  of  UIC's  read.  The  UIC  count  is  also  used  to  indicate  the 
number  of  directory  records  generated. 

3.  Figure  2  illustrates  the  error  message  displayed  when  a  read  error 
occurs  while  reading  the  FORSTQ  file.  Processing  will  continue  with 
the  remaining  FORSTQ  records. 

4.  Figure  3  shows  the  error  message  displayed  when  a  write  error  occurs 
while  building  the  directory  file.  As  with  a  read  error,  processing 

on  the  file  will  continue. 
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UTC  TOTAL  001265 
UTC  TOTAL  012174 


Figure  1.  Final  Processing  Messages 
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APPENDIX  D 


1.  Appendix  D  contains  the  system  flowchart  for  UTCTAB.  A  macro  flowchart 
is  provided  to  give  the  user  an  overview  of  the  functions  performed  to 
generate  the  UTC-U1C  Directory  File.  The  processing  flow  is  divided 
into  four  basic  sections,  with  distinct  functions  performed  in  each 
section.  They  are: 

Section  A:  Read  FORSTQ  file  and  extract  required  data 
Section  B:  Sort  data 

Section  C:  Read  sorted  data  and  build  directory  file 
Section  D:  Print  final  processing  report 


Figure  1,  (Part  A  of  3) 


